home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / StartupTools / IconifyGadget.readme < prev    next >
Text File  |  1996-09-26  |  10KB  |  239 lines
  1. Short:    Adds iconify gadget to windows. BETA version.
  2. Author:   Håkon Enger (henger@fys.uio.no)
  3. Uploader: henger@fys.uio.no
  4. Version:  0.7 beta
  5. Type:     util/misc
  6.  
  7. NOTE: This is a beta version. If you use this program, it WILL cause
  8. your computer to crash, sooner or later. If you still want to try it,
  9. I would be grateful if you tell me when you find a bug.
  10.  
  11. This is a minor update from version 0.6, with no real bug fixes...
  12.  
  13. CHANGES SINCE VERSION 0.6:
  14.  · Small error in gadget image, showing up with certain screen font
  15.    sizes corrected.
  16.  · Added Width and MoveRight parameters
  17.  · Configuring from ENV:IconifyGadget.config
  18.  
  19. Commodities/IconifyGadget                          Commodities/IconifyGadget
  20.  
  21.  
  22.     NAME
  23.         IconifyGadget - add iconify gadget to windows
  24.  
  25.  
  26.     USAGE
  27.         IconifyGadget [Screens {WORKBENCH|PUBLIC|ALL}] [IKey <keyseq>]
  28.                       [WBWindows {NO|ICONIFY|CLOSE}] [3DLook]
  29.                       [CX_Priority <pri>] [Width <width>] [MoveRight]
  30.  
  31.  
  32.     REQUIREMENTS
  33.  
  34.         Any Amiga computer with Workbench 2.0 or higher.
  35.  
  36.  
  37.     FUNCTION
  38.  
  39.         If you run a lot of programs that open windows on the Workbench
  40.         screen, the screen easily gets overcrowded. IconifyGadget helps
  41.         with this problem by adding an option to iconify windows. Windows
  42.         that are iconified are temporarily removed from view and replaced
  43.         by an icon. When the icon is double-clicked on, the window appears
  44.         again and the icon disappears. Iconifying windows with Iconify-
  45.         Gadget is done by clicking on a new gadget appearing to the left
  46.         of the "Zoom" gadget in the upper right corner of the window, or
  47.         by pressing a user-selectable key defined by the IKEY parameter.
  48.         Not all windows are iconifiable, see the DISCUSSION section below
  49.         for details. Also read the WARNING and BUGS sections below.
  50.  
  51.         IconifyGadget is a commodity, so it can be controlled by the
  52.         Commodities Exchange utility. Removing IconifyGadget is
  53.         dangerous if other programs have patched the library functions
  54.         that are patched by IconifyGadget. Se DISCUSSION.
  55.  
  56.         The gadget used is visually similar to the iconify gadget used by
  57.         MUI, which is also used by KCON. An alternate image is provided
  58.         and may be selected with the 3DLOOK switch. This image may be
  59.         preferred if you use "SysIHack".
  60.  
  61.         Which icon to use for different windows and windows that should
  62.         not get an iconify gadget may be specified in the file
  63.         ENV:IconifyGadget.config. Each line should contain a pattern for
  64.         the window title followed be any number of blanks, followed by
  65.         either the filename of an icon to use (without .info) or the
  66.         keyword "NotIconify" meaning that the window should not recieve
  67.         an iconify gadget. The pattern for the title is a standard
  68.         AmigaDOS pattern.
  69.  
  70.  
  71.     PARAMETERS
  72.  
  73.         All parameters can be used as tooltypes when started from WB or
  74.         as command line parameters when started from the Shell.
  75.  
  76.  
  77.         SCREENS     Define which screen(s) the programs will affect.
  78.                     Specifying WORKBENCH will only affect windows on the
  79.                     Workbench screen, PUBLIC will affect windows on all
  80.                     public screens, and ALL will affect windows on all
  81.                     screens. Since the icons appear only on the WB screen,
  82.                     iconifying windows on other screens seems a little
  83.                     weird, but if you want it, there it is. Default is
  84.                     WORKBENCH
  85.  
  86.         IKEY        Specify a key sequence that will iconify the active
  87.                     window. Default is none.
  88.  
  89.         WBWINDOWS   What to do with Workbench windows. Since WB windows
  90.                     (disks, drawers etc.) already have icons, there is
  91.                     really no use in creating another. Still, if you
  92.                     want to iconify WB windows just like all other,
  93.                     specify ICONIFY. If you want an iconify gadget for
  94.                     completeness, but not to create another icon, specify
  95.                     CLOSE. This will make the iconify gadget act exactly
  96.                     like the close gadget. Default is NO.
  97.  
  98.         3DLOOK      For those who like to fool around with sysihack, this
  99.                     switch gives an alternate image for the gadget.
  100.  
  101.         CX_PRIORITY Priority for the commodities exchange broker.
  102.  
  103.         WIDTH       Width of the iconify gadget. If not specified, the
  104.                     standard width will be used, based on the resolution
  105.                     of the screen.
  106.  
  107.         MOVERIGHT   Move the gadget right if there is no zoom gadget.
  108.                     This might be confusing since the iconify gadget might
  109.                     be mistaken for the zoom gadget, so it's an option.
  110.  
  111.  
  112.     DISCUSSION
  113.  
  114.         This program is one I have wanted to write ever since I got hold
  115.         of Ewout Walraven's "Iconify". That program made it possible to
  116.         iconify most windows by pressing ctrl and double-clicking in
  117.         them, but I wanted a gadget to click on! So here it is, finally
  118.         in beta version. Comments and bugreports are welcomed!
  119.  
  120.         I owe a lot to Ewout Walraven for this program, even if he
  121.         doesn't know it himself. The method used for iconifying the
  122.         windows was inspired by "Iconify", and also the icon was stolen
  123.         from there.
  124.  
  125.         The program works by adding a gadget to all windows that are
  126.         iconifyable. That means that they are refreshable and not gimme-
  127.         zerozero or borderless. If the window already has a gadget in the
  128.         position where IconifyGadget adds it's gadget, the window is
  129.         considered not iconifyable by IconifyGadget. This is usually
  130.         because the program that uses the window has provided a way
  131.         to iconify thw window. The windows are iconified by resizing and
  132.         moving the layer of the window to the bottom left corner of the
  133.         screen. (Clicking in this corner may give strange results for
  134.         some windows!) The window is never really removed from the screen,
  135.         so the screen can not be closed if there are any iconified windows
  136.         left.
  137.  
  138.         When the windows are iconified, they will be represented by an
  139.         AppIcon on the Workbench screen. Double-clicking on this icon will
  140.         bring back to full sized window to the front of the screen.
  141.  
  142.         IconifyGadget patches the following intuition.library functions:
  143.         OpenWindow, OpenWindowTagList, CloseWindow, AddGadget and
  144.         WindowToFront. If a program that patches any of these is started
  145.         after IconifyGadget, it should be removed before IconifyGadget is
  146.         removed. Alternatively, you can use a utility such as PatchControl
  147.         to handle the patches.
  148.  
  149.  
  150.     WARNING
  151.  
  152.         Fooling around with other programs' windows is NOT a nice thing to
  153.         do. If you don't like to take chances, don't use this program.
  154.  
  155.  
  156.     BUGS
  157.  
  158.         This is a beta version, so there are probably lots of unknown bugs.
  159.  
  160.         Since this program seriously hacks the system, it's probably not
  161.         possible to eliminate all 'bugs' (cf the warning above). I'll try
  162.         to do my best, however.
  163.  
  164.         There is a that makes CPR crash if you try to add an iconify gadget
  165.         to it's windows. I have not been able to find out why this happens.
  166.  
  167.         The following bugs were reported by people trying v0.6:
  168.         · MUI3 windows get two iconify gadgets (mine and theirs).
  169.           Solution: Turn of iconifying for either MUI or IG (using the
  170.           config file). (First reported by Carl Seward)
  171.         · Workbench windows like Execute and Info can be iconified, but
  172.           since workbench is frozen while these windows show (not Info in
  173.           OS3.0+), the icons never show up and hence they cannot be un-
  174.           iconified. Solution: Use the config file to ban these windows
  175.           from iconifying. (First reported by John Gardi) 
  176.         · Adding an iconify gadget to the CPUsage meter of SuperDashBoard
  177.           causes a crash. Solution: Same as above (for now...)
  178.           (Also reported by John Gardi)
  179.         · Using the AppChange option of MCP causes a crash. Solution:
  180.           don't use it. (Sorry, but there's really not much I can do
  181.           about it.) (First reported by Troy Davis)
  182.         · Flemming Steffensen reported that the width of the gadget is
  183.           wrong on his machine. I don't know why, but if anybody else
  184.           have this problem, please let me know! Solution: use the
  185.           WIDTH parameter to set the width.
  186.  
  187.         Some windows mysteriously un-iconifies themselves if you click in
  188.         the lower right corner of the screen.
  189.  
  190.         Some windows are empty when they are un-iconified. This will
  191.         probably be solved in a later version.
  192.  
  193.         When you find a bug, please inform me on how it occured. If you
  194.         have the source code to the program that was making IconifyGadget
  195.         crash, it would be of great help to me if you could send that too.
  196.         My address (email and otherwise) is at the end of this document.
  197.  
  198.  
  199.     THANKS
  200.  
  201.         Thanks to Ewout Walraven for making the Iconify program.
  202.  
  203.         Thanks to everybody who reported bugs and had suggestions to the
  204.         first release of IconifyGadget.
  205.  
  206.  
  207.     COPYRIGHT
  208.  
  209.         IconifyGadget is Copyright © 1995 Håkon Enger
  210.  
  211.         This beta version may not be distributed without explicit
  212.         permission from the author. Such permission is given to the AmiNet
  213.         collection of Amiga software FTP sites.
  214.  
  215.  
  216.     AUTHOR
  217.  
  218.         Håkon Enger
  219.  
  220.         Email addresses: henger@fys.uio.no, haakone@ifi.uio.no. If one of
  221.         them bounces, try the other one.
  222.  
  223.         Regular mail should be addressed to:
  224.             Håkon Enger
  225.             Rikard Nordraaksveg 12
  226.             N-2400 Elverum
  227.             Norway
  228.  
  229.  
  230. ============================= Archive contents =============================
  231.  
  232. Original  Packed Ratio    Date     Time    Name
  233. -------- ------- ----- --------- --------  -------------
  234.    18012    9821 45.4% 25-Jan-96 08:38:48  IconifyGadget
  235.      624     320 48.7% 25-Jan-96 00:10:04  IconifyGadget.info
  236.     9911    3878 60.8% 25-Jan-96 00:13:56  IconifyGadget.readme
  237. -------- ------- ----- --------- --------
  238.    28547   14019 50.8% 27-Jan-96 05:03:00   3 files
  239.